Send PTP (Precision Time Protocol) command of taking photo.
int MV_GIGE_IssueActionCommand( MV_ACTION_CMD_INFO *pstActionCmdInfo, MV_ACTION_CMD_RESULT_LIST *pstActionCmdResults );
[IN] Command information, see the structure MV_ACTION_CMD_INFO for details.
[OUT] Returned information list, see the structure MV_ACTION_CMD_RESULT_LIST for details.
Return MV_OK(0) on success, and return Error Code on failure.
This API is supported only by GigEVision camera.
The following sample code is for reference only.
#include <stdio.h>
#include <process.h>
#include <conio.h>
#include "MvCameraControl.h"
bool g_bExit = false;
bool g_bReceive = false;
unsigned int g_nPayloadSize = 0;
unsigned int g_DeviceKey = 1;
unsigned int g_GroupKey = 1;
unsigned int g_GroupMask= 1;
//Wait for key input
void WaitForKeyPress(void)
{
while(!_kbhit())
{
Sleep(10);
}
_getch();
}
static unsigned int __stdcall ActionCommandWorkThread(void* pUser)
{
int nRet = MV_OK;
MV_ACTION_CMD_INFO stActionCmdInfo = {0};
MV_ACTION_CMD_RESULT_LIST stActionCmdResults = {0};
stActionCmdInfo.nDeviceKey = g_DeviceKey;
stActionCmdInfo.nGroupKey = g_GroupKey;
stActionCmdInfo.nGroupMask = g_GroupMask;
stActionCmdInfo.pBroadcastAddress = "255.255.255.255";
stActionCmdInfo.nTimeOut = 100;
stActionCmdInfo.bActionTimeEnable = 0;
while(!g_bExit)
{
nRet = MV_GIGE_IssueActionCommand(&stActionCmdInfo,&stActionCmdResults);
if (MV_OK != nRet)
{
printf("Issue Action Command fail! nRet [0x%x]\n", nRet);
}
printf("NumResults = %d\r\n",stActionCmdResults.nNumResults);
MV_ACTION_CMD_RESULT* pResults = stActionCmdResults.pResults;
for (unsigned int i = 0;i < stActionCmdResults.nNumResults;i++)
{
printf("Ip == %s, Status == 0x%x\r\n",pResults->strDeviceAddress,pResults->nStatus);
pResults++;
}
}
return 0;
}
static unsigned int __stdcall ReceiveImageWorkThread(void* pUser)
{
int nRet = MV_OK;
MV_FRAME_OUT_INFO_EX stImageInfo = {0};
memset(&stImageInfo, 0, sizeof(MV_FRAME_OUT_INFO_EX));
unsigned char * pData = (unsigned char *)malloc(sizeof(unsigned char) * (g_nPayloadSize));
if (pData == NULL)
{
return 0;
}
unsigned int nDataSize = g_nPayloadSize;
while(1)
{
nRet = MV_CC_GetOneFrameTimeout(pUser, pData, nDataSize, &stImageInfo, 1000);
if (nRet == MV_OK)
{
g_bExit = true;
printf("Get One Frame: Width[%d], Height[%d], nFrameNum[%d]\n",
stImageInfo.nWidth, stImageInfo.nHeight, stImageInfo.nFrameNum);
}
else
{
printf("No data[0x%x]\n", nRet);
}
if(g_bExit)
{
break;
}
}
free(pData);
return 0;
}
int main()
{
int nRet = MV_OK;
void* handle = NULL;
do
{
//Enumerate device
MV_CC_DEVICE_INFO_LIST stDeviceList;
memset(&stDeviceList, 0, sizeof(MV_CC_DEVICE_INFO_LIST));
nRet = MV_CC_EnumDevices(MV_GIGE_DEVICE | MV_USB_DEVICE, &stDeviceList);
if (MV_OK != nRet)
{
printf("Enum Devices fail! nRet [0x%x]\n", nRet);
break;
}
if (m_stDevList.nDeviceNum == 0)
{
printf("no camera found!\n");
return 0;
}
//Select device and create handle
nRet = MV_CC_CreateHandle(&handle, stDeviceList.pDeviceInfo[0]);
if (MV_OK != nRet)
{
printf("Create Handle fail! nRet [0x%x]\n", nRet);
break;
}
//Open camera
nRet = MV_CC_OpenDevice(handle);
if (MV_OK != nRet)
{
printf("Open Device fail! nRet [0x%x]\n", nRet);
break;
}
//Get optimal network packet size (It works only for GigE camera)
if (stDeviceList.pDeviceInfo[0]->nTLayerType == MV_GIGE_DEVICE)
{
int nPacketSize = MV_CC_GetOptimalPacketSize(handle);
if (nPacketSize > 0)
{
nRet = MV_CC_SetIntValue(handle,"GevSCPSPacketSize",nPacketSize);
if(nRet != MV_OK)
{
printf("Warning: Set Packet Size fail nRet [0x%x]!", nRet);
}
}
else
{
printf("Warning: Get Packet Size fail nRet [0x%x]!", nPacketSize);
}
}
//Set Action Device Key
nRet = MV_CC_SetIntValue(handle, "ActionDeviceKey", g_DeviceKey);
if (MV_OK != nRet)
{
printf("Set Action Device Key fail! nRet [0x%x]\n", nRet);
break;
}
//Set Action Group Key
nRet = MV_CC_SetIntValue(handle, "ActionGroupKey", g_GroupKey);
if (MV_OK != nRet)
{
printf("Set Action Group Key fail! nRet [0x%x]\n", nRet);
break;
}
//Set Action Group Mask
nRet = MV_CC_SetIntValue(handle, "ActionGroupMask", g_GroupMask);
if (MV_OK != nRet)
{
printf("Set Action Group Mask fail! nRet [0x%x]\n", nRet);
break;
}
//Get packet size
MVCC_INTVALUE stParam;
memset(&stParam, 0, sizeof(MVCC_INTVALUE));
nRet = MV_CC_GetIntValue(handle, "PayloadSize", &stParam);
if (MV_OK != nRet)
{
printf("Get PayloadSize fail! nRet [0x%x]\n", nRet);
break;
}
g_nPayloadSize = stParam.nCurValue;
//Start acquisition
nRet = MV_CC_StartGrabbing(handle);
if (MV_OK != nRet)
{
printf("Start Grabbing fail! nRet [0x%x]\n", nRet);
break;
}
unsigned int nReceiveImageThreadID = 0;
void* hReceiveImageThreadHandle = (void*) _beginthreadex( NULL , 0 , ReceiveImageWorkThread , handle, 0 , &nReceiveImageThreadID );
if (NULL == hReceiveImageThreadHandle)
{
break;
}
unsigned int nActionCommandThreadID = 0;
void* hActionCommandThreadHandle = (void*) _beginthreadex( NULL , 0 , ActionCommandWorkThread , NULL, 0 , &nActionCommandThreadID );
if (NULL == hActionCommandThreadHandle)
{
return 0;
}
printf("Press a key to stop grabbing.\n");
WaitForKeyPress();
g_bExit = true;
Sleep(1000);
//Stop acquisition
nRet = MV_CC_StopGrabbing(handle);
if (MV_OK != nRet)
{
printf("Stop Grabbing fail! nRet [0x%x]\n", nRet);
break;
}
//Shut device
nRet = MV_CC_CloseDevice(handle);
if (MV_OK != nRet)
{
printf("ClosDevice fail! nRet [0x%x]\n", nRet);
break;
}
//Destroy handle
nRet = MV_CC_DestroyHandle(handle);
if (MV_OK != nRet)
{
printf("Destroy Handle fail! nRet [0x%x]\n", nRet);
break;
}
} while (0);
if (nRet != MV_OK)
{
if (handle != NULL)
{
MV_CC_DestroyHandle(handle);
handle = NULL;
}
}
printf("Press a key to exit.\n");
WaitForKeyPress();
return 0;
}
Send PTP (Precision Time Protocol) command of taking photo.
int MV_GIGE_IssueActionCommand( MV_ACTION_CMD_INFO *pstActionCmdInfo, MV_ACTION_CMD_RESULT_LIST *pstActionCmdResults );
[IN] Command information, see the structure MV_ACTION_CMD_INFO for details.
[OUT] Returned information list, see the structure MV_ACTION_CMD_RESULT_LIST for details.
Return MV_OK(0) on success, and return Error Code on failure.
This API is supported only by GigEVision camera.
The following sample code is for reference only.
#include <stdio.h>
#include <process.h>
#include <conio.h>
#include "MvCameraControl.h"
bool g_bExit = false;
bool g_bReceive = false;
unsigned int g_nPayloadSize = 0;
unsigned int g_DeviceKey = 1;
unsigned int g_GroupKey = 1;
unsigned int g_GroupMask= 1;
//Wait for key input
void WaitForKeyPress(void)
{
while(!_kbhit())
{
Sleep(10);
}
_getch();
}
static unsigned int __stdcall ActionCommandWorkThread(void* pUser)
{
int nRet = MV_OK;
MV_ACTION_CMD_INFO stActionCmdInfo = {0};
MV_ACTION_CMD_RESULT_LIST stActionCmdResults = {0};
stActionCmdInfo.nDeviceKey = g_DeviceKey;
stActionCmdInfo.nGroupKey = g_GroupKey;
stActionCmdInfo.nGroupMask = g_GroupMask;
stActionCmdInfo.pBroadcastAddress = "255.255.255.255";
stActionCmdInfo.nTimeOut = 100;
stActionCmdInfo.bActionTimeEnable = 0;
while(!g_bExit)
{
nRet = MV_GIGE_IssueActionCommand(&stActionCmdInfo,&stActionCmdResults);
if (MV_OK != nRet)
{
printf("Issue Action Command fail! nRet [0x%x]\n", nRet);
}
printf("NumResults = %d\r\n",stActionCmdResults.nNumResults);
MV_ACTION_CMD_RESULT* pResults = stActionCmdResults.pResults;
for (unsigned int i = 0;i < stActionCmdResults.nNumResults;i++)
{
printf("Ip == %s, Status == 0x%x\r\n",pResults->strDeviceAddress,pResults->nStatus);
pResults++;
}
}
return 0;
}
static unsigned int __stdcall ReceiveImageWorkThread(void* pUser)
{
int nRet = MV_OK;
MV_FRAME_OUT_INFO_EX stImageInfo = {0};
memset(&stImageInfo, 0, sizeof(MV_FRAME_OUT_INFO_EX));
unsigned char * pData = (unsigned char *)malloc(sizeof(unsigned char) * (g_nPayloadSize));
if (pData == NULL)
{
return 0;
}
unsigned int nDataSize = g_nPayloadSize;
while(1)
{
nRet = MV_CC_GetOneFrameTimeout(pUser, pData, nDataSize, &stImageInfo, 1000);
if (nRet == MV_OK)
{
g_bExit = true;
printf("Get One Frame: Width[%d], Height[%d], nFrameNum[%d]\n",
stImageInfo.nWidth, stImageInfo.nHeight, stImageInfo.nFrameNum);
}
else
{
printf("No data[0x%x]\n", nRet);
}
if(g_bExit)
{
break;
}
}
free(pData);
return 0;
}
int main()
{
int nRet = MV_OK;
void* handle = NULL;
do
{
//Enumerate device
MV_CC_DEVICE_INFO_LIST stDeviceList;
memset(&stDeviceList, 0, sizeof(MV_CC_DEVICE_INFO_LIST));
nRet = MV_CC_EnumDevices(MV_GIGE_DEVICE | MV_USB_DEVICE, &stDeviceList);
if (MV_OK != nRet)
{
printf("Enum Devices fail! nRet [0x%x]\n", nRet);
break;
}
if (m_stDevList.nDeviceNum == 0)
{
printf("no camera found!\n");
return 0;
}
//Select device and create handle
nRet = MV_CC_CreateHandle(&handle, stDeviceList.pDeviceInfo[0]);
if (MV_OK != nRet)
{
printf("Create Handle fail! nRet [0x%x]\n", nRet);
break;
}
//Open camera
nRet = MV_CC_OpenDevice(handle);
if (MV_OK != nRet)
{
printf("Open Device fail! nRet [0x%x]\n", nRet);
break;
}
//Get optimal network packet size (It works only for GigE camera)
if (stDeviceList.pDeviceInfo[0]->nTLayerType == MV_GIGE_DEVICE)
{
int nPacketSize = MV_CC_GetOptimalPacketSize(handle);
if (nPacketSize > 0)
{
nRet = MV_CC_SetIntValue(handle,"GevSCPSPacketSize",nPacketSize);
if(nRet != MV_OK)
{
printf("Warning: Set Packet Size fail nRet [0x%x]!", nRet);
}
}
else
{
printf("Warning: Get Packet Size fail nRet [0x%x]!", nPacketSize);
}
}
//Set Action Device Key
nRet = MV_CC_SetIntValue(handle, "ActionDeviceKey", g_DeviceKey);
if (MV_OK != nRet)
{
printf("Set Action Device Key fail! nRet [0x%x]\n", nRet);
break;
}
//Set Action Group Key
nRet = MV_CC_SetIntValue(handle, "ActionGroupKey", g_GroupKey);
if (MV_OK != nRet)
{
printf("Set Action Group Key fail! nRet [0x%x]\n", nRet);
break;
}
//Set Action Group Mask
nRet = MV_CC_SetIntValue(handle, "ActionGroupMask", g_GroupMask);
if (MV_OK != nRet)
{
printf("Set Action Group Mask fail! nRet [0x%x]\n", nRet);
break;
}
//Get packet size
MVCC_INTVALUE stParam;
memset(&stParam, 0, sizeof(MVCC_INTVALUE));
nRet = MV_CC_GetIntValue(handle, "PayloadSize", &stParam);
if (MV_OK != nRet)
{
printf("Get PayloadSize fail! nRet [0x%x]\n", nRet);
break;
}
g_nPayloadSize = stParam.nCurValue;
//Start acquisition
nRet = MV_CC_StartGrabbing(handle);
if (MV_OK != nRet)
{
printf("Start Grabbing fail! nRet [0x%x]\n", nRet);
break;
}
unsigned int nReceiveImageThreadID = 0;
void* hReceiveImageThreadHandle = (void*) _beginthreadex( NULL , 0 , ReceiveImageWorkThread , handle, 0 , &nReceiveImageThreadID );
if (NULL == hReceiveImageThreadHandle)
{
break;
}
unsigned int nActionCommandThreadID = 0;
void* hActionCommandThreadHandle = (void*) _beginthreadex( NULL , 0 , ActionCommandWorkThread , NULL, 0 , &nActionCommandThreadID );
if (NULL == hActionCommandThreadHandle)
{
return 0;
}
printf("Press a key to stop grabbing.\n");
WaitForKeyPress();
g_bExit = true;
Sleep(1000);
//Stop acquisition
nRet = MV_CC_StopGrabbing(handle);
if (MV_OK != nRet)
{
printf("Stop Grabbing fail! nRet [0x%x]\n", nRet);
break;
}
//Shut device
nRet = MV_CC_CloseDevice(handle);
if (MV_OK != nRet)
{
printf("ClosDevice fail! nRet [0x%x]\n", nRet);
break;
}
//Destroy handle
nRet = MV_CC_DestroyHandle(handle);
if (MV_OK != nRet)
{
printf("Destroy Handle fail! nRet [0x%x]\n", nRet);
break;
}
} while (0);
if (nRet != MV_OK)
{
if (handle != NULL)
{
MV_CC_DestroyHandle(handle);
handle = NULL;
}
}
printf("Press a key to exit.\n");
WaitForKeyPress();
return 0;
}